12.2 修改终端信息

请求参数

Path： /api/v1/device/update

Method： POST

接口描述：

1. 修改终端信息。
2. 对于更新接口中的非必须参数，如果不传，不会对该条数据相对应参数进行修改。
3. 如果修改后的终端信息与已存在的终端冲突，则更新失败。
4. 判断和已存在终端冲突的规则：
   • 请求参数中含有 newExternalId 在设备上已存在终端中，匹配到了相同 externalId 的终端。
   • 根据控制台设置的【终端匹配规则】，mac、计算机名称 与设备上已存在的终端一致。
5. 接口适用于 v2.2.9 及以上版本。

请求参数

Headers

Body

请求示例

{
    "externalId": "0c4e9039-f81d-11ec-a760-fefcfe545bb7",
    "newExternalId": "0c4e9039-f81d-11ec-a760-fefcfe545bb8",
    "name": "DESKTOP-I3ABQBS",
    "mac": ["FE-FC-FE-21-F5-D1", "FE-FC-FE-21-F5-D2"],
    "deviceType": "PC",
    "assetType": "BYOD"
}

返回数据

返回示例

{
    "code": 0,
    "data": {
        "externalId": "0c4e9039-f81d-11ec-a760-fefcfe545bb8"
    },
    "msg": "请求成功",
    "traceId": "0022c672e4c8b0d6"
}

错误信息